TextSpresso includes minimal AppleScript support, including the Required Suite of Apple Events (run, open, print, and quit) and a TextSpresso specific Apple Event (filter). We decided to go ahead and release a version with this minimal but functional support because several of our users had requested that we try to do so ASAP. We will be expanding TextSpresso's support of AppleScript with additional Apple Events and object model support in the near future.
Users can now use AppleScript to command TextSpresso to filter a document or some text, or any combination thereof in a list, with a specific, named filter via the filter event. The samples in this folder demonstrate how to call the filter event.
Some important notes:
* TextSpresso filters the passed files directly. If you want TextSpresso to filter duplicates, duplicate the files within your script and then pass the duplicates to filter.
* The calling script must, of course, wait for TextSpresso to finish processing any passed strings. However, it does not have to wait for TextSpresso to finish processing documents. TextSpresso only waits on documents to reply if the wait parameter is included.
* Files filtered via filter do not have their resource forks preserved. This is generally only an issue for non-text files. (We'll add this option soon.)
* Unregistered versions of TextSpresso cannot execute the open, print, or filter commands from launch. They must be launched and the register screen dismissed before they can process those events.
* TextSpresso does not check the file type of files passed via filter. If your script might encounter non-text files you should error check this within your script. (The flip side of this is that if you need TextSpresso to filter data files that are not of type TEXT, filter will not get in your way and prevent this.)
* The name of the filter must be exact. If you're having trouble with a particular script, check the name parameter.
* When TextSpresso receives a filter event it creates a temporary batch document, adds the files to the document, and then applies the filter. When the filter is done, the batch document is automatically closed. This means that you can switch to TextSpresso and view the progress or stop the filtering. (Note that on Power Macs you probably won't have time to do this unless you're filtering a lot of files.)
If you have any questions about the existing Apple Events, or suggestions for additional Apple Events, please contact us at:
